home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / mxlibs / mdss040a / midp.doc < prev    next >
Encoding:
Text File  |  1995-04-27  |  21.1 KB  |  651 lines
  1.  
  2.  
  3.                                                                               
  4.  
  5.  
  6.                           MIDAS Module Player v1.00b
  7.                           --------------------------
  8.  
  9.             Copyright 1995 Petteri Kangaslampi and Jarno Paananen
  10.  
  11.  
  12.         MIDAS MODULE PLAYER IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  13.         EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES
  14.         OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
  15.         WILL ANY OF THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES
  16.         CAUSED BY THE USE, OR INABILITY TO USE, OF MIDAS MODULE PLAYER.
  17.  
  18.         MIDAS Module Player may freely be distributed as long as no money is
  19.         charged for it, and no attempt is made to restrict further copying,
  20.         distribution and using of MIDAS Module Player. If you have problems
  21.         with this, or do not understand this, contact us.
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                               
  65.  
  66.  
  67.  
  68. MIDAS Module Player                      Foreword                       Page 2
  69.  
  70.  
  71. 1. Foreword
  72.  
  73.         As the version number shows, this is the first version of MIDP which
  74.         we consider fully finished. Do not let it mislead you though, as MIDP
  75.         is now almost a year old and has several releases already behind. All
  76.         of the bugs reported from previous versions, mainly v0.41 and v0.42,
  77.         have been fixed and numerous features have been added. MIDP is now
  78.         very stable, at least on all computers tested, and plays almost every
  79.         module it recognizes correctly. There is no other PC player we know of
  80.         which plays Protracker or Scream Tracker 3 modules better than MIDP.
  81.  
  82.         However, we are still looking for feedback. During this long break in
  83.         MIDAS releases, MIDAS Sound System has gone through an extensive
  84.         rewrite, and is now much cleaner and more modular. Loads of bugs have
  85.         been fixed and new features added, including support for Multitracker
  86.         modules. To understand how well we have succeeded we need your
  87.         comments. Especially we are looking for feedback regarding sound card
  88.         support, as this is a major cause of problems in PC world today, and
  89.         we are also very interested in hearing from you if you find a module
  90.         that MIDP does not play correctly. And of course, if MIDP simply
  91.         refuses to work on your computer please contact us.
  92.  
  93.         When giving us feedback, especially bug reports, please remember to
  94.         include information about your computer system, especially the type of
  95.         your sound card. Please also include, if possible, the MIDAS error
  96.         list given by MIDP on an error situation. It gives us invaluable
  97.         information about the error and, even more importantly, where that
  98.         error occurred.  This way we have better chances of finding the bugs.
  99.         Also, if you encouter another kind of problem, such as Expanded Memory
  100.         Manager exception dump or divide error (MIDP has its own internal
  101.         divide error handler), please include as much of the information as
  102.         possible, at least the exact error message and all addresses given.
  103.         Otherwise we will not be able to locate the problem.
  104.  
  105.         Unlike most other module players, MIDP is not commercial, shareware,
  106.         or even cardware. But, if you like MIDP, nothing naturally stops you
  107.         from sending us something, money, a postcard or whatever. We would
  108.         hope to get at least a "Hey, MIDP works with my sound card" e-mail
  109.         message, but please include the type of the sound card as well.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                               
  130.  
  131.  
  132.  
  133. MIDAS Module Player                    Configuration                    Page 3
  134.  
  135.  
  136. 2. Configuration
  137.  
  138. ----------------------------------------------------------------------------
  139. 2.1. Introduction
  140. ----------------------------------------------------------------------------
  141.  
  142.         When you run MIDAS Module Player for the first time, you will be
  143.         prompted for configuration information including sound card type,
  144.         port, IRQ, DMA and sound output mode. Use cursor up/down to select the
  145.         correct values, Enter to confirm and Escape to exit. The
  146.         detected/recommended values will be highlighted as default, but please
  147.         verify each selection before proceeding as these might be incorrect.
  148.         The configuration information is saved to file MIDP.CFG, in the same
  149.         directory with MIDP.EXE, and will be used in the future when MIDP is
  150.         run.
  151.  
  152.         After the initial configuration, you can use the command line
  153.         arguments to override the settings for one session, or use the command
  154.         line option "-r" to completely reconfigure MIDP. Settings forced using
  155.         the command line arguments are not saved to MIDP.CFG.
  156.  
  157. ----------------------------------------------------------------------------
  158. 2.2. Sound Devices
  159. ----------------------------------------------------------------------------
  160.  
  161.         MIDAS uses all sound cards through modules called Sound Devices. One
  162.         Sound Device can include support for several sound cards which are
  163.         functionally alike. In the configuration screen each supported sound
  164.         card will appear as a separate selection, but if you later wish to
  165.         force the sound card type from command line you must set both Sound
  166.         Device and sound card type numbers.
  167.  
  168.         Currently available Sound Devices are:
  169.  
  170.         1. Gravis UltraSound
  171.                 * Available sound card types: (-cx option)
  172.                         1 - Gravis UltraSound (GF1 hardware mixing)
  173.                 * All Gravis UltraSound versions
  174.  
  175.         2. Media Vision Pro Audio Spectrum series
  176.                 * Available sound card types: (-cx option)
  177.                         1 - Pro Audio Spectrum
  178.                         2 - Pro Audio Spectrum plus
  179.                         3 - Pro Audio Spectrum 16
  180.                 * Note that with normal PAS mixing rates over 22kHz may not
  181.                   work properly.
  182.  
  183.         3. Microsoft Windows Sound System
  184.                 * Available sound card types: (-cx option)
  185.                         1 - Windows Sound System (Crystal/Analog CODEC)
  186.                 * Should also work with other WSS compatible cards, such as
  187.                   Compaq Business Audio, and is tested to work with Audiotrix
  188.                   Pro.
  189.                 * Note that there is no autodetection for this Sound Device.
  190.  
  191.  
  192.  
  193.  
  194.                                                                               
  195.  
  196.  
  197.  
  198. MIDAS Module Player                    Configuration                    Page 4
  199.  
  200.  
  201.         4. Creative Labs Sound Blaster series
  202.                 * Available sound card types: (-cx option)
  203.                         1 - Sound Blaster 1.0 or clone (DSP v1.xx)
  204.                         2 - Sound Blaster 1.5 (DSP v2.00)
  205.                         3 - Sound Blaster 2.0 (DSP v2.01)
  206.                         4 - Sound Blaster Pro (DSP v3.xx)
  207.                         5 - Sound Blaster 16 (DSP v4.00+)
  208.  
  209.         5. No Sound
  210.                 * Available sound card types: (-cx option)
  211.                         1 - No Sound
  212.                 * Plays nothing, is always used when nothing else is detected.
  213.                 * Just to allow sound synchronization even with no sound card.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                               
  260.  
  261.  
  262.  
  263. MIDAS Module Player              MIDAS Module Player usage              Page 5
  264.  
  265.  
  266. 3. MIDAS Module Player usage
  267.  
  268. ----------------------------------------------------------------------------
  269. 3.1. Command line syntax
  270. ----------------------------------------------------------------------------
  271.  
  272.         The command line syntax for MIDP is:
  273.  
  274.                 MIDP [options] <filenames> [options]
  275.  
  276.                 At least one module file name must be included. MIDP also
  277.                 supports multiple modules and wildcards.
  278.  
  279.         Options:
  280.                 -r      Reconfigure MIDAS Module Player. This prompts for new
  281.                         Sound Card, Port, IRQ and DMA values and output mode,
  282.                         and saves them to MIDP.CFG for later use.
  283.                 -sx     Force Sound Device x (1 = GUS, 2 = PAS, 3 = WSS, 4 =
  284.                         SB, 5 = No Sound)
  285.                 -cx     Force sound card type x (depends on Sound Device)
  286.                 -pxxx   Force I/O port xxx (hex) for Sound Device
  287.                 -ix     Force IRQ x for Sound Device
  288.                 -dx     Force DMA channel x for Sound Device
  289.                 -mxxxx  Set mixing rate to xxxx Hz
  290.                 -oxxx   Force output mode (8 = 8-bit, 1 = 16-bit, s = stereo,
  291.                         m = mono). Can be combined, eg. 8-bit mono is "-o8m"
  292.                 -b      Disable Virtual DMA usage. Use this if you experience
  293.                         problems related to Virtual DMA Servies.
  294.                 -e      Disable EMS usage
  295.                 -t      Disable BPM tempos in Protracker modules. Necessary
  296.                         with some (usually older) modules that attempt to use
  297.                         speeds over 31.
  298.                 -g      Disable DMP-compatible 8-command panning in Protracker
  299.                         modules. Needed if the module uses the command 8 for
  300.                         other purposes, such as music synchronization in a
  301.                         demo.
  302.                 -x      Enable extended octaves in Protracker modules. May be
  303.                         needed with some modules using notes in octaves above
  304.                         3 or below 1. If this option is not enabled the notes
  305.                         may be cutted at the Amiga period limits.
  306.                 -u      Enable Surround sound (affects only GUS). Uses twice
  307.                         the amount of GUS memory, but allows Surround panning.
  308.                         MIDP is the only player we know of that supports
  309.                         surround panning on GUS.
  310.                 -ax     Force amplification level x. 64 is normal (no
  311.                         amplification), 128 200% etc.
  312.                 ------
  313.                 -v      Disable real VU-meters (saves memory)
  314.                 -y      Disable timer screen synchronization
  315.                 -Y      Enable timer screen synchronization also in DOS shell
  316.                 -O      Scramble module playing order
  317.                 -nxx    Default panning. Channels normally on left are panned
  318.                         to -xx, and those on right to xx. For example, if you
  319.                         are using headphones, try -n24.
  320.                 -M      Display free memory information
  321.  
  322.  
  323.  
  324.                                                                               
  325.  
  326.  
  327.  
  328. MIDAS Module Player              MIDAS Module Player usage              Page 6
  329.  
  330.  
  331.         Also '/' is recognized as option delimiter.
  332.         Note that the options are CASE SENSITIVE.
  333.  
  334. ----------------------------------------------------------------------------
  335. 3.2. Environment variables
  336. ----------------------------------------------------------------------------
  337.  
  338.         MIDAS Sound System specific options (above the line in the command
  339.         line option list above) can also be set to environment variable MIDAS,
  340.         so that they do not have to be entered every time. The syntax is
  341.         exactly the same as with the command line options. Also other programs
  342.         that use MIDAS Sound System will probably recognize the environment
  343.         variable.
  344.  
  345.         Any MIDP command line options can also be placed in environment
  346.         variable MIDP, including also those below the line. This is preferred
  347.         over the use of MIDAS environment. Note that you can override the
  348.         options set in the environment variable from the command line.
  349.  
  350.         Example:
  351.                 SET MIDAS=-s3 -p530 -i9 -d3 -om -m32000
  352.  
  353. ----------------------------------------------------------------------------
  354. 3.3. Keyboard
  355. ----------------------------------------------------------------------------
  356.  
  357.         When playing a module, MIDP can be controlled using the following
  358.         keys:
  359.  
  360.                 Alt-X           Quick exit
  361.                 Esc             Exit with fade out
  362.                 +/-             Increase / Decrease master volume
  363.                 D               Jump to DOS shell
  364.                 Left/Right      Next / Previous position
  365.                 Up/Down         Select active channel
  366.                 Page Up/Down    Scroll instrument list
  367.                 Tab             Toggle instrument list mode
  368.                 1-9, 0          Toggle channels on/off
  369.                 ,/.             Adjust active channel panning left / right
  370.                 M               Set active channel panning to middle
  371.                 L               Set active channel panning to left
  372.                 R               Set active channel panning to right
  373.                 U               Set active channel panning to surround
  374.                 T               Toggle active channel on/off
  375.                 P               Pause module. Pree P to continue
  376.                 Space           Mute playing. Press Space again to un-mute
  377.                 N               Next module
  378.                 A               Amplification adjustment screen. See below for
  379.                                 more information.
  380.                 V               Show MIDAS and MIDP version information.
  381.                 F               Display free memory information
  382.                 B               Display free memory blocks
  383.                 F1, h           Display keyboard help
  384.                 F8              Toggle screen blanking on/off
  385.  
  386.  
  387.  
  388.  
  389.                                                                               
  390.  
  391.  
  392.  
  393. MIDAS Module Player              MIDAS Module Player usage              Page 7
  394.  
  395.  
  396. ----------------------------------------------------------------------------
  397. 3.4. Amplification
  398. ----------------------------------------------------------------------------
  399.  
  400.         When playing multiple channel digital sound, the output volume can get
  401.         very low and sound quality with 8-bit sound cards decreases. MIDAS
  402.         Sound System compensates for this using amplification. When playing on
  403.         a 8-bit sound card, the sound is amplified as a default and also on
  404.         16-bit sound cards amplification can be added. This increases volume
  405.         level and also improves sound quality on 8-bit cards. You can override
  406.         the default amplification level using the "-ax" command line option,
  407.         and adjust it while playing by pressing the "A" key.
  408.  
  409.         Keys in amplification adjustment screen:
  410.  
  411.                 ./,             Multiply / divide current amplification level
  412.                                 by two.
  413.                 +/-             Add / substract 16 to the current
  414.                                 amplification level
  415.                 V               Toggle output VU-meter mode between mixer
  416.                                 output and channel VU meter sum.
  417.                 A               Toggle automatic amplification limits on/off.
  418.  
  419.         Note that on 16-bit sound cards the sound will get distorted very
  420.         quickly if you use too high amplification values. This is because
  421.         there is no clipping in the sound mixer and the output will wrap. On
  422.         8-bit sound cards the mixing output is clipped and thus you can use
  423.         higher amplification values without problems.
  424.  
  425. ----------------------------------------------------------------------------
  426. 3.5. Archive support
  427. ----------------------------------------------------------------------------
  428.  
  429.         MIDP also includes a primitive archive support, built as we ourselves
  430.         needed it. When playing a file with extension .ZIP, .MDZ, .S3Z or .MTZ
  431.         MIDP first decompresses the file using PKUNZIP to the directory set by
  432.         environment variable "TEMP", or to C:\ if none is set. Then the first
  433.         file from that directory with same name as the archive (but with any
  434.         extension) will be played and deleted immediately after playing
  435.         starts.  When multiple archives are being played, the decompression of
  436.         the next start immediately after starting to play the previous one, to
  437.         give almost uninterrupted background music.
  438.  
  439.         Archive support will be enhanced in the future, after we implement
  440.         some kind of configuration file, to include any archivers and
  441.         extensions.  But for now this must do. Please also note that the
  442.         archive support fails if the archive is stored in the TEMP directory.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                                                                               
  455.  
  456.  
  457.  
  458. MIDAS Module Player                     The future                      Page 8
  459.  
  460.  
  461. 4. The future
  462.  
  463.         MIDAS Module Player, as the whole MIDAS Sound System itself, is under
  464.         constant development. As time permits we will add more features to
  465.         MIDP, both to test new functions in MIDAS and to enhance its
  466.         usefulness. MIDP currently represents what we think a module player
  467.         should be like, but we are open to suggestions. So if you feel there
  468.         is an important feature missing, or think that the existing ones are
  469.         somehow faulty or unintuitive to use, do not hesitate to contact us.
  470.  
  471.         Features planned for some future MIDP version:
  472.  
  473.         - Configuration file, including customizable archiver support, colors,
  474.         character set etc.
  475.  
  476.         - Module-specific configuration, probably added to 4DOS descript.ion
  477.         file in the form of MIDP command line options for each module file
  478.  
  479.         - File selector with 4DOS description support
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.                                                                               
  520.  
  521.  
  522.  
  523. MIDAS Module Player                 Contact information                 Page 9
  524.  
  525.  
  526. 5. Contact information
  527.  
  528.         If you have questions, comments, suggestions or bug reports about
  529.         MIDAS Module Player or MIDAS Sound System itself, please contact us.
  530.         The preferred method is naturally e-mail, because it is fast,
  531.         inexpensive and lets us deal with the messages when we have time. Note
  532.         also that we probably will not be able to answer your letters unless
  533.         you include a stamped and addressed return envelope (International
  534.         Reply Coupon is OK too).
  535.  
  536.         e-mail:
  537.                 pekangas@sci.fi (Petteri Kangaslampi)
  538.                 jpaana@kauhajoki.fi (Jarno Paananen)
  539.  
  540.         voice:
  541.                 +358-31-3646764 (Petteri Kangaslampi)
  542.                 +358-31-3422147 (Jarno Paananen)
  543.                 Please restrict your calls to 10.00 - 21.30, Finnish time.
  544.  
  545.         normal mail:
  546.                 Petteri Kangaslampi
  547.                 Simeoninkuja 4
  548.                 FIN-36240 Kangasala 4
  549.                 Finland
  550.                 Europe
  551.  
  552.                 Jarno Paananen
  553.                 Puskalantie 6
  554.                 FIN-37120 Nokia
  555.                 Finland
  556.                 Europe
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.                                                                               
  585.  
  586.  
  587.  
  588. MIDAS Module Player                    Distribution                    Page 10
  589.  
  590.  
  591. 6. Distribution
  592.  
  593.                 The latest MIDAS Sound System and MIDAS Module Player should
  594.                 always be available on these fine BBSes:
  595.  
  596.                 WarmBoot BBS            +55-194-265112
  597.                         Sysop: Carlos Henrique Cantu (WarmBooter)
  598.  
  599.                 Moir Brandts Honk       #1: +31-(0)70-3461215 USR/DS 14.4k
  600.                                         #2: +31-(0)70-3457929 ZyXEL 19.2k
  601.                                         #3: +31-(0)70-3452981 LineLink 14.4k
  602.                         Sysop: Hugo Voerman
  603.  
  604.                 The Pantheon            703-378-3553 (changing soon?)
  605.                         Sysops: Farmicus [CiA], Lord Soth [iCE], and Shaggy
  606.                 [iCE
  607.                         Senior Staff]
  608.  
  609.                 ULTiMAT BBS             +32-2-3755651
  610.                         Sysops: Cobra, Access
  611.  
  612.                 Sourcery BBS            +46-8-7674313
  613.                         Sysop: Martin Alexanderson
  614.                         Fidonet: 2:201/406, Freq.
  615.  
  616.                 If you are supposed to be a MIDAS distribution site, but are
  617.                 not on this list, please contact us!
  618.  
  619.                 MIDAS and MIDP can also be found in Internet. Whenever a new
  620.                 version is released, we will try to upload it to at least
  621.                 ftp.cdrom.com, /pub/msdos/demos/incoming/music and
  622.                 x2ftp.oulu.fi.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                                                               
  650.  
  651.